The Itential SNMP MIB defines ten notification types to inform OSS systems about system health events. Notifications are sent for both system events (restart and error) and southbound adapter events (established, unreachable, and error).
SNMP Notification Types
Below is a list of supported notification types.
| Notification | Object ID | Description |
|---|---|---|
itenSBAdapterUnreach |
1.3.6.1.4.1.47688.1.1.1.0.1 |
An adapter related trap indicating that a connection could not be established to the specified southbound adapter. |
itenSBAdapterEstab |
1.3.6.1.4.1.47688.1.1.1.0.2 |
An adapter related trap indicating that a connection to the specified southbound adapter has been established. |
itenSBAdapterFuncErr |
1.3.6.1.4.1.47688.1.1.1.0.3 |
An adapter related trap indicating that an error has occurred with the specified southbound adapter. |
itenProngSystemRestart |
1.3.6.1.4.1.47688.1.1.1.0.4 |
A trap indicating that Itential Automation Platform (IAP) has restarted. |
itenProngSysErr |
1.3.6.1.4.1.47688.1.1.1.0.5 |
A trap containing the contents of a critical error encountered by IAP. |
itenProngAppUp |
1.3.6.1.4.1.47688.1.1.1.0.6 |
An application related trap indicating that an application is online. |
itenProngAppDown |
1.3.6.1.4.1.47688.1.1.1.0.7 |
An application related trap indicating that an application is offline. |
itenProngAppCrash |
1.3.6.1.4.1.47688.1.1.1.0.8 |
An application related trap indicating that an application has crashed unexpectedly. |
itenSBAdapterDegraded |
1.3.6.1.4.1.47688.1.1.1.0.9 |
An adapter related trap indicating that a connection to the specified southbound adapter has become degraded. |
itenSBAdapterFixed |
1.3.6.1.4.1.47688.1.1.1.0.10 |
An adapter related trap indicating that a connection to the specified southbound adapter is no longer degraded. |
Notifications may contain additional variable bindings providing detailed information about the event. These variable bindings can be used to identify specific components and error messages.
Below is a list of objects supported by each notification type.
| Notification | Objects | Description |
|---|---|---|
itenSBAdapterUnreach |
itenProngComponentID, itenProngAdapterIP4, itenProngAdapterPort |
The southbound adapter unreachable notifications contain the ID, IP and port of the unreachable instance. |
itenSBAdapterEstab |
itenProngComponentID, itenProngAdapterIP4, itenProngAdapterPort |
The southbound adapter established notifications contain the ID, IP and port of the unreachable instance. |
itenSBAdapterFuncErr |
itenProngComponentID, itenProngAdapterFunction, itenProngAdapterError |
The southbound adapter error notifications contain the ID and function name and error text. |
itenProngSystemRestart |
The system restart notifications do not contain any detailed objects. | |
itenProngSysErr |
itenProngSystemError |
The system error notifications contain a string description of the error. |
itenProngAppUp |
itenProngComponentID |
The application up notifications contain the ID of the unreachable instance. |
itenProngAppDown |
itenProngComponentID |
The application down notifications contain the ID of the unreachable instance. |
itenProngAppCrash |
itenProngComponentID |
The application crash notifications contain the ID of the unreachable instance. |
itenSBAdapterDegraded |
itenProngComponentID, itenProngAdapterIP4, itenProngAdapterPort |
The southbound adapter degraded notifications contain the ID, IP and port of the unreachable instance. |
itenSBAdapterFixed |
itenProngComponentID, itenProngAdapterIP4, itenProngAdapterPort |
The southbound adapter no longer degraded notifications contain the ID, IP and port of the unreachable instance. |
SNMP MIB File Location
Often used with management and monitoring systems, the SNMP MIB files can be located within the directory structure of an installed instance of IAP:
# cd /opt/pronghorn/current/node_modules/@itential/pronghorn-core/core/mibs/
# ls -l
-rw-r--r-- 1 admin staff 9252 Feb 15 12:39 ITENTIAL-MIB.txt
-rw-r--r-- 1 admin staff 1490 Feb 15 12:13 ITENTIAL-SMI-MIB.txt